The VBVRLog acts as a server for inbound linestatus and log data requests from internet clients It can also monitor VBVoice applications remotely across a network.
To begin monitoring a remote VBVoice application, start VBVRLog with the command line VBVRLOG.EXE remote. This causes VBVRLog to show a dialog where you can choose a remote server to monitor, or to monitor the local machine. A shortcut is provided in the VBVoice Start Menu for this option.
To bypass the dialog, use the command line VBVRLog remote machinename.
VBVoice creates an index file for log entries using a .VLI extension which is used in conjunction with the .VLG log file.
The .VLG file contains all the information, but the VBVRLog can open files without the index file. However, the index file improves load times and it is necessary for the Call Detail ADO object to retrieve call data.
Context menu items allow you to control the display of items in the log window.
|
Hide Controls |
Collapses any expanded control items so that only the control name line is shown. |
|
Expand Controls |
Expands the display so that the controls visited by each call are visible. |
|
Expand All |
Expands the display so that all logs are visible. |
VBVRLog has a series of toolbars that allow channel selection for log display and a quick view of line status. The color of each channel button changes as its status changes.
Tool tip text for each button will pop up if the mouse hovers over the channel button, showing a more complete line status without having to scroll the linestatus display.
The colour-coding of channel buttons is very useful in systems with large line counts, such as T1 systems where line pooling may mean you do not know which channel a call arrives on. The channel button will change colour so that you can find that channel immediately.
You can change the colour of the channel buttons. There are four colours available, corresponding to the idle, waiting for ring, pre-call delay, and unknown. The default colour for each state can be changed using settings for the RGB values in VBVRLog.INI, section [Buttons]
The default encoded RGB values are:
|
Delay |
0x0000FFFF (green) |
|
Idle |
0x00FF8040 (red) |
|
Active |
0x0030FF40 (yellow) |
|
WaitRing |
0x00C0C040 (blue) |
VBVRLog.EXE communicates with other servers and with Internet browsers using a communication mechanism called a socket.
Each socket is assigned a port number. VBVRLog uses 8081 as the default port number. When there are conflicts or issues with Internet firewalls, you can change this port number. The port on the server and the client must be identical.
To change the port number, use this setting in VBVRLOG.INI:
[VBVRLog]
port=8081
VBVoice logs can be very detailed and contain a large amount of data. To reduce the size of log files or to reduce network traffic on remote logging, you could exclude certain types of logs.
Each log is classified into the types. Each bit in the log filter corresponds to a log type. If the bit is set, the log is used, otherwise it is ignored.
|
0 |
Voice events: low level device driver interaction |
|
1 |
Voice functions: low level device driver interaction |
|
2 |
Error messages |
|
3 |
Invalid digit, timeout messages |
|
4 |
General messages |
|
5 |
Changes to call-flow from code |
|
6 |
System messages |
|
7,8,9 |
Control messages: enter and exit controls |
|
10,11,12 |
Start and end call messages |
|
13 |
Primary call details |
|
14 |
Secondary call details |
|
EXAMPLE |
A filter value of 0x1FFC will enable system, call, control, and error messages but disable call details, voice functions, and events. |
To filter logs as they are written to the file, use this setting in VBVoice.INI:
[LogFilter]
WriteLog = 0x----
This setting will reduce the size of the file, but will also reduce debugging capability in the event of an error.
To control which logs are displayed in a VBVRLog window, use this setting in VBVoice.INI:
[LogFilter]
Display = 0x----
This setting (on the client) will also control which logs are sent to a client VBVRLog program monitoring a remote server. An instance of VBVRLog on a server will send any logs requested by a client - either an Internet browser client or a VBVRLog client.
Read more about other ways you can manipulate log files, including adding items to log files, flushing the log to disk, and deleting log files.